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PREFACE 


This manual describes PAL-llR, the Assembly Language 
and Assembler for the PDP-11 Disk Operating System. Thus, 
familiarity with the DOS Monitor (see PDP-11 Disk Operating 
System Monitor, Programmer's Handbook, DEC-ll-MWDA-D) is 
assumed. 

The manual explains how to write PAL-llR source pro- 
grams and how to assemble them into object modules. All 
facets of the assembly language are explained and illus- 
trated with many examples, and the manual concludes with 
assembling procedures. 

In explaining how to write PAL-llR source programs, 
it is necessary, especially at the outset, to make fre- 
quent forward references. Therefore, we recommend that 
you first read through the entire manual to get a "feel" 
for the language, and then reread the manual for a complete 
understanding of the language and assembling procedures. 

In addition to the PAL-llR Assembler, the Disk 
Operating System software includes: 

DOS Monitor 
Edit-11 Text Editor 
ODT-llR Debugging Program 
PIP, File Utility Package 
Link-11 Linker 
Libr-11 Librarian 
FORTRAN IV 
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CHAPTER 1 


INTRODUCTION 


PAL-llR (Program Assembly Language for the PDP-11, Relocatable 
Version) operates under the Disk Operating System (DOS) . PAL-llR 
enables you to write source (symbolic) programs using letters, 
numbers, and symbols which are meaningful to you. The source 
programs, generated either on-line using the Text Editor Edit-11 
(see PDP-11 Edit-11 Text Editor, Programmer's Manual, DEC-ll-EEDA-D 
for details) , or off-line are then assembled into object modules 
which are processed by the PDP-11 Linker, Link-11. Link-11 produces 
a load module which is loaded by the monitor command RUN for execu- 
tion. Object modules may contain absolute and/or relocatable code, 
and separately assembled object modules may be linked with global 
symbols. The object module is produced after two passes through the 
Assembler. A complete octal/symbolic listing of the assembled program 
may also be obtained. This listing is especially useful for documenta- 
tion and debugging purposes. 

Some notable features of PAL-llR are: 

1. Selective assembly pass functions 

2. Device and file name specification for pass functions 

3. Error listing on command output device 

4. Double buffered and concurrent I/O 

5. Alphabetized, formatted symbol table listing 

6. Relocatable object modules 

7. Global symbols for linking between object modules 

8. Conditional assembly directives 

9 . Program sectioning directives 

The following discussion of the PAL-llR Assembly Language 
assumes that you have read the PDP-11 Handbook 1971 , with emphasis 
on those sections which deal with the PDP-11 instruction set, formats, 
and timings -- a thorough knowledge of these is vital to efficient 
assembly language programming. 




CHAPTER 2 


STATEMENTS 


A source program is composed of a sequence of statements, where each 
statement is on a single line. The statement is terminated by a 
carriage return character and must be immediately followed by either 
a line feed or form feed character. Should a carriage return char- 
acter be present and not be followed by a line feed or form feed, 
the Assembler will generate a Q error (Chapter 10) , and that portion 
of the line following the carriage return will be ignored. Since 
the carriage return is a required statement terminator, a line feed 
or form feed not immediately preceded by a carriage return will have 
one inserted by the Assembler. 

It should be noted that, if the Edit-11 Text Editor is being 
used to create the source program, a typed carriage return (RETURN 
key) automatically generates a line feed character. 

A statement may be composed of up to four fields which are 
identified by their order of appearance and by specified terminating 
characters as explained below and summarized in Appendix B. The 
four fields are: 

Label Operator Operand Comment 

The label and comment fields are optional. The operator and 
operand fields are interdependent, i.e., either may be omitted 
depending upon the contents of the other. 

2.1 CHARACTER SET 

A PAL-llR source program is composed of symbols, numbers, expres- 
sions, symbolic instructions, assembler directives, argument sepa- 
rators, and line terminators written using the following ASCII^ 
characters . 

1. The letters A through Z. (Upper and lower case letters 
are acceptable, although upon input, lower case letters 
will be converted to upper case letters.) 

^ASCII stands for American Standard Code for Information Interchange. 
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2 . The numbers 0 through 9 . 

3. The characters . and $ (these characters are reserved for 

systems use) . 

4. The separating or terminating symbols: 

carriage return tab space line feed form feed 
2.2 LABEL 

A label is a user-defined symbol (Chapter 3) which is assigned the 
value of the current location counter. This value may be either 
absolute or relocatable, depending on whether the location counter 
value is absolute or relocatable. In the latter case, the final 
absolute value is assigned by the Linker, i.e., the value plus the 
relocation constant. A label is a symbolic means of referring to a 
specific location within a program. If present, a label always 
occurs first in a statement and must be terminated by a colon. For 
example, if the current location is absolute IOOq, the statement: 

O 

ABCD: MOV A,B 

will assign the value lOOg to the label ABCD so that subsequent 
reference to ABCD will be to location lOOg. In the above example 
if the location counter were relocatable, the final value of ABCD 
would be lOOg+K, where K is the location of the beginning of the 
relocatable section in which the label ABCD appears. More than one 
label may appear within a single label field; each label within the 
field will have the same value. For example, if the current location 
counter is 100, multiple labels in the statement* 

ABC: $DD: A7.7: MOV A,B 

will equate each of the three labels ABC, $DD, and A7 . 7 with the 
value 100 Q. ($ and . are reserved for system software.) 

O 

The error code M (multiple definition of a symbol) will be gen- 
erated during assembly if two or more labels have the same first six 
characters . 
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2 . 3 OPERATOR 


An operator follows the label field in a statement, and may be an 
instruction mnemonic or an assembler directive (Appendix B) . When 
it is an instruction mnemonic, it specifies what action is to be 
performed on any operand (s) which follows it. When it is an assem- 
bler directive, it specifies a certain function or action to be 
performed during assembly. 

The operator may be preceded only by one or more labels and may 
be followed by one or more operands and/or a comment. An operator 
is legally terminated by a space, tab, or any of the following 
characters : 

# + - @ ("•%!& , ; 

line feed form feed carriage return 

The use of each character above will be explained. 

Consider the following examples: 

MOV->-|a,B ; ^1 (TAB) terminates operator MOV 

MOV@A,B ; @ terminates operator MOV 

When the operator stands alone without an operand or comment, 
it is terminated by a carriage return followed by a line feed or 
form feed character. 

2.4 OPERAND 

An operand is that part of a statement which is operated on by the 
operator — an instruction mnemonic or assembler directive. 

Operands may be symbols, expressions, or numbers. When multiple 
operands appear within a statement, each is separated from the next 
by a comma. An operand may be preceded by an operator and/or label, 
and followed by a comment. 

The operand field is terminated by a semicolon when followed by 
a comment, or by a carriage return followed by a line feed or form 
feed character when the operand ends the statement. For example : 
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LABEL : MOV GEORGE , BOB 


;THIS IS A COMMENT 


where the space between MOV and GEORGE terminated the operator field 
and began the operand field; the comma separated the operands GEORGE 
and BOB; the semicolon terminated the operand field and began the 
comment. 

2 . 5 COMMENTS 

The comment field is optional and may contain any ASCII character 
except null, rubout, carriage return, line feed, or form feed. All 
other characters, even those with special significance, are ignored 
by the Assembler when used in the comment field. 

The comment field may be preceded by none, any, or all of the 
other three fields. It must begin with the semicolon and end with a 
carriage return followed by a line feed or form feed character. For 
example: 

LABEL: CLR HERE ;THIS IS A $1.00 COMMENT 

Comments do not affect assembly processing or program execution, 
but they are useful in program listings for later analysis, checkout, 
or documentation purposes. 

2.6 FORMAT CONTROL 

Formatting of the source program is controlled by the space and tab 
characters. They have no effect on the assembling process of the 
source program unless they are embedded within a symbol, number, or 
ASCII text; or are used as the operator field terminator. Thus, they 
can be used to provide a neat, readable program. A statement can be 
written : 

LABEL : MOV ( SP )+, TAG; POP VALUE OFF STACK 
or, using formatting characters, it can be written: 

LABEL: MOV (SP)+,TAG ; POP VALUE OFF STACK 

which is much easier to read. 

Page size is controlled by the form feed character. A page of n 
lines is created by inserting a form feed (CTRL/FORM keys on the key- 
board) after the nth line. If no form feed is present, a page is termi 
nated after 56 lines. 
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CHAPTER 3 


SYMBOLS 


There are two types of symbols: permanent and user-defined. There 
are two symbol tables: the Permanent Symbol Table (PST) and the User 
Symbol Table (UST) . The PST contains all the permanent symbols and 
is part of the Assembler's load module. The UST is constructed as 
the source program is assembled; user-defined symbols are added to 
the table as they are encountered. 

3.1 PERMANENT SYMBOLS 

Permanent symbols consist of the instruction mnemonics (Appendix B.3) 
and assembler directives (Chapter 8) . These symbols are a permanent 
part of the Assembler and need not be defined before being used in 
the source program. 

3.2 USER-DEFINED SYMBOLS 

User-defined symbols are those defined as labels (Section 2.2) or by 
direct assignment (Section 3.3). These symbols are added to the 
User Symbol Table as they are encountered during the first pass of 
the assembly. They can be composed of alphanumeric characters, 
dollar signs, and periods only; any other character is illegal and, 
if used, will result in the error message I (Chapter 10) . (Again, $ 
and . are reserved for system software.) The following rules also apply 
to user-defined symbols : 

1. The first character must not be a number. 

2. Each symbol must be unique within the first six characters. 

3. A symbol may be written with more than six legal characters 
but the seventh and subsequent characters are only checked 
for legality, and are not otheinvise recognized by the 
Assembler . 

4. Spaces and tabs must not be embedded within a symbol. 

A user-defined symbol may duplicate a permanent symbol. The 
value associated with a permanent symbol that is also user-defined 
depends upon its use: 

1. A permanent symbol encountered in the operator field is 
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2 . 


associated with its corresponding machine op-code. 

If a permanent symbol in the operand field is also user- 
defined, its user-defined value is associated with the 
symbol. If the symbol is not found to be user-defined, 
then the corresponding machine op-code absolute value is 
associated with the symbol. 

User-defined symbols are either internal or global. All 
symbols are internal unless they are explicitly defined as global 
with the .GLOBL assembler directive (Section 8.2). 

Global symbols are used to provide links between object modules. 

A global symbol which is defined (as a label or direct assignment) in 
a program is called an entry symbol or entry point. Such symbols may 
be referred to from other object modules or assemblies. A global 
symbol which is not defined in the current assembly is called an exter- 
nal symbol. Some other assembly must define the same symbol as an 
entry point. 

Since PAL-llR provides program sectioning capabilities (Section 
8.3), two types of internal symbols must be considered: 

1. a symbol that belongs to the current program section; 

2. a symbol that belongs to any of the other program sections. 

In both cases, the symbol must be defined within the current assembly; 
the significance of the distinction is critical in evaluating expres- 
sions involving type 2. above (Section 4.4). 

3. 3 DIRECT ASSIGNMENT 

A direct assignment statement associates a symbol with a value. 

When a direct assignment statement defines a symbol for the first 
time, that symbol is entered into the Assembler's symbol table and 
the specified value is associated with it. A symbol may be rede- 
fined by assigning a new value to a previously defined symbol. The 
newly assigned value will replace the previous value assigned to 
the symbol . 

The symbol takes on the relocatable or absolute attribute of the 
defining expression. However, if the defining expression is global, 
the defined symbol will not be global unless previously defined as such 
(Chapter 4) . 
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The general format for a direct assignment statement is; 

symbol = expression 
The following conventions apply: 

1. An equal sign (=) must separate the symbol from the 
expression defining the symbol. 

2. A direct assignment statement may be preceded by a label 
and may be followed by a comment. 

3. Only one symbol can be defined by any one direct assignment 
statement . 

4. Only one level of forward referencing is allowed. 

Example of two levels of forward referencing (illegal) : 

X = Y 
Y = Z 
Z = 1 

X and Y are both undefined throughout pass 1 and will be listed on 
the command output device as such at the end of that pass. X is 
undefined throughout pass 2 , and will cause a U error message. 

Examples ; 

A = 1 ;THE SYMBOL A IS EQUATED WITH THE VALUE 1. 

B = ’A-l&MASKLOW ;THE SYMBOL B IS EQUATED WITH THE EXPRES- 

S'S ION'S VALUE 

C: D = 3 ;THE SYMBOL D IS EQUATED WITH 3. THE 

E: MOV #1,ABLE ; LABELS C AND E ARE EQUATED WITH THE 

; NUMERICAL MEMORY ADDRESS OF THE MOV 
; COMMAND . 

3.4 REGISTER SYMBOLS 

The eight general registers of the PDP-11 are numbered 0 through 7. 
These registers may be referenced by use of a register symbol; that 
is, a symbolic name for a register. A register symbol is defined 
by means of a direct assignment, where the defining expression con- 
tains at least one term preceded by a % or at least one term previ- 
ously defined as a register symbol. In addition, the defining 


3-3 



expression of a register symbol must be absolute. For example; 


DEFINE RjZf AS REGISTER 0 
DEFINE R3 AS REGISTER 3 
DEFINE R4 AS REGISTER 4 
DEFINE THERE AS REGISTER 2 

It is important to note that all register symbols must be 
defined before they are referenced. A forward reference to a 
register symbol will generally cause phase errors (Chapter 10) . 

The % may be used in any expression thereby indicating a 
reference to a register. Such an expression is a register expres- 
sion. Thus, the statement: 

CLR %6 

will clear register 6 while the statement: 

CLR 6 

will clear the word at memory address 6. In certain cases a register 
can be referenced without the use of a register symbol or register 
expression. These cases are recognized through the context of the 
statement and are thoroughly explained in Sections 7.11 and 7.12. 

Two obvious examples of this are: 

JSR 5,SUBR ;THE FIRST OPERAND FIELD MUST ALWAYS BE 

;A REGISTER. 

CLR X(2) ;ANY EXPRESSION ENCLOSED IN ( ) MUST BE 

;A REGISTER. IN THIS CASE, INDEX REGIS- 
;TER 2. 


R3=R0+3 

R4=l+%3 

THERE=%2 
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CHAPTER 4 

EXPRESSIONS 


Arithmetic and logical operators (see Section 4.2) may be used to form 
expressions. A term of an expression may be a permanent symbol, a user- 
defined symbol (which may be absolute, relocatable, or global), a num- 
ber, ASCII data, or the present value of the assembly location counter 
represented by the period. Expressions are evaluated from left to 
right. Parenthetical grouping is not allowed. 

Expressions are evaluated as word quantities. The operands 
of a .BYTE directive (Section 8.8) are evaluated as word expressions 
before truncation to the low-order eight bits. The evaluation of 
an expression includes the evaluation of the mode of the resultant 
expression; that is, absolute, relocatable or external. The defini- 
tion of the modes of expression are given below in Section 4.4. 

A missing term, expression or external symbol will be interpreted 
as 0. A missing operator will be interpreted as +. The error code Q 
(Questionable syntax) will be generated for a missing operator. For 
example : 


A + -100 ;OPERAND MISSING 

will be evaluated as A + 0 - 100, and: 

TAG : LA 177777 ; OPERATOR MISSING 

will be evaluated as TAG 1 LA+177777. 

The value of an external expression will be the value of the 
absolute part of the expression; e.g., EXT+A will have a value of A. 
This will be modified by the Linker to become EXT+A. 

4.1 NUMBERS 

The Assembler accepts both octal and decimal numbers. Octal numbers 
consist of the digits 0 through 7 only. Decimal numbers consist of 
the digits 0 through 9 followed by a decimal point. If a number 
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contains an 8 or 9 and is not followed by a decimal point, the N 
error code (Chapter 10) will be printed and the number will be 
interpreted as decimal. Negative numbers may be expressed as a 
number preceded by a minus sign rather than in a two's complement 
form. Positive numbers may be preceded by a plus sign although 
this is not required. 

If a number is too large to fit into 16 bits, the number is 
truncated from the left. In the assembly listing the statement will 
be flagged with a Truncation (T) error. Numbers are always consid- 
ered to be absolute quantities (that is, not relocatable) . 

4.2 ARITHMETIC AND LOGICAL OPERATORS 


The arithmetic operators are: 

+ indicates addition or a positive number 

indicates subtraction or a negative number 


The logical operators are: 


& indicates the logical 
I indicates the logical 

AND 

0 & 0 = 0 
0 & 1 = 0 
1 & 0 = 0 
1 & 1 = 1 


AND operation 
inclusive OR operation 

OR 

0 10 = 0 
0 11 = 1 
110=1 
111 = 1 


4.3 ASCII CONVERSION 

When preceded by an apostrophe, any ASCII character (except null, 
rubout, carriage return, line feed, or form feed) is assigned the 
7-bit ASCII value of the character (Appendix A) . For example: 


'A 


is assigned the value 
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When preceded by a quotation mark, two ASCII characters (not 
including null, rubout, carriage return, line feed, or form feed) 
are assigned the 7-bit ASCII values of each of the characters to be 
used. Each 7-bit value is stored in an 8-bit byte and the bytes 
are combined to form a word. For example "AB will store the ASCII 
value of A in the low-order (even) byte and the value of B in the 
high-order (odd) byte; 

high-order byte j 

I 

B's value = 10 2 ' 

0 100 001 0 ^ 

0 ""l^ 

I 
I 
I 

"A3=j2(4 11)2(1 

ASCII text is always absolute. 

4.4 MODE OF EXPRESSIONS 

The mode of an expression may be absolute, relocatable in the current 
program section, relocatable in another program section, or external 
as defined below. 

A term of an expression is absolute, relocatable (current section 
or other section), or external, correspondingly as its definer _(iie., 
number, symbol, etc.) is absolute, relocatable (current or other), or 
external. Numbers, permanent symbols, and generated data are always 
treated as absolute. 

An absolute expression is defined as: 

1. Absolute term preceded optionally by a single plus or 
minus sign or 

2. Relocatable expression minus a relocatable term where both 
items belong to the same program section or 

3. Absolute expression followed by an operator followed by 
an absolute expression. 

A relocatable (current or other program section) expression is 
defined as; 
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1. Relocatable term, or 

2. Relocatable expression followed by an arithmetic operator 
followed by an absolute expression, or 

3. Absolute expression followed by a plus operator followed 
by a relocatable expression. 


An external expression is defined as: 


1. External term, or 

2. External expression followed by an arithmetic operator 
followed by an absolute term, or 

3. Absolute expression followed by a plus operator followed 
by an external expression. 


In the following examples: 


ABS is an absolute symbol 

RELC is a relocatable symbol in current program section 
RELO is a relocatable symbol in non-current program section 
EXT is an external symbol 


Examples ; 


Legal Expressions 


Illegal Expressions 


; EXTERNAL EXPRESSIONS 

EXT 

EXT -ABS 
ABS +EXT 

; RELOCATABLE EXPRESSION 
RELC 

RELC+ABS 

ABS+RELC 

RELC+RELC-RELC 

RELO 

RELO-ABS 

ABS+RELO 

RELO+RELO-RELO 

RELO-RELO+RELO 


EXT+RELC 

EXT+RELO 

RELC+RELC 

RELO+RELO 

ABS -RELC 

RELC-RELO 

RELO-EXT 

RELO I RELO 

RELC&RELC 


; ABSOLUTE EXPRESSION 

RELC -RELC 
RELO-RELO 
ABS+RELC-RELC&ABS 
ABS+RELO-RELO ! ABS 
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CHAPTER 5 


ASSEMBLY LOCATION COUNTER 


The period (.) is the symbol for the assembly location counter. 

When used in the operand field of an instruction, it represents the 
address of the first word of the instruction. When used in the 
operand field of an assembler directive, it represents the address of 
the current byte or word. For example: 

A; MOV #.,Rj2f REFERS TO LOCATION A, 

;I.E., THE ADDRESS OF THE 
;MOV INSTRUCTION. 

(# is explained in Section 7.9). 

At the beginning of each assembly pass, the Assenibler clears the 
location counter. Normally, consecutive memory locations are 
assigned to each byte of object data generated. However, the location 
where the object data is stored may be changed by a direct assignment 
altering the location counter: 

.=expression 

Similar to other symbols, the location counter symbol . has a 
mode associated with it. However, the mode cannot be external. 

Neither can one change the existing mode of the location counter by 
using a defining expression of a different mode. 

The mode of the location counter symbol can be changed by the 
use of the .ASECT or .CSECT directive as explained in Section 8.3. 

The expression defining the location counter must not contain 
forward references or symbols that vary from one pass to another. 

Examples : 

;SET LOCATION COUNTER TO ABSOLUTE 
;500 


•ASECT 

.=500 
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FIRST: 


MOV 


+10, COUNT 


THE LABEL FIRST HAS THE VALUE 500g 
.+10 EQUALS 510g. THE CONTENTS OF 
THE LOCATION 510 „ WILL BE DEPOSITED 

O 

IN LOCATION COUNT. 


.=520 ;the assembly location counter now 

;HAS A VALUE OF ABSOLUTE 520 g. 

SECOND: MOV INDEX ;THE LABEL SECOND HAS THE VALUE 520g. 

;THE CONTENTS OF LOCATION 520 g, THAT 
;IS, THE BINARY CODE FOR THE INSTRUC- 
;TION ITSELF, WILL BE DEPOSITED IN 
; LOCATION INDEX. 


.CSECT 

.=.+20 ;SET LOCATION COUNTER TO RELOCATABLE 

;20 OF THE UNNAMED PROGRAM SECTION. 


THIRD: .WORD 0 


;THE LABEL THIRD HAS THE VALUE OF 
; RELOCATABLE 20. 


Storage area may be reserved by advancing the location counter. 
For example, if the current value of the location counter is 1000, 
the direct assignment statement 
.=.+100 

will reserve lOOg bytes of storage space in the program. The next 
instruction will be stored at 1100. 
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CHAPTER 6 


RELOCATION AND LINKING 


The output of the relocatable assembler is an object module which 
must be processed by the Link-11 Linker before loading and execution. 

(See PDP-11 Link-11 Linker, Programmer's Manual, DEC-ll-ZLDA-D for 
details.) The Linker essentially fixes (i.e., makes absolute) 
the values of external or relocatable symbols and creates another 
module (load module) which contains the binary data to be loaded and 
executed. 

To enable the Linker to fix the value of an expression, the 
Assembler issues certain directives to the Linker together with the 
required parameters. In the case of relocatable expressions the 
Linker adds the base of the associated relocatable section (the 
location in memory of relocatable 0) to the value of the relocatable 
expression provided by the Assembler. In the case of an external 
expression the value of the external term in the expression is 
determined by the Linker (since the external symbol must be defined 
in one of the other object modules which are being linked together) 
and adds it to the value of the external expression provided by the 
assembler. 

All instructions that are to be modified as described above will 
be marked by an apostrophe in the assembly listing. Thus the 
binary text output will look as follows for the given examples: 

; VALUE OF EXTERNAL SYMBOL 
; ASSEMBLED ZERO; WILL BE 
; MODIFIED BY THE LINKER. 

;THE ABSOLUTE PORTION OF THE 
; EXPRESS ION (000006) IS ADDED 
;BY THE LINKER TO THE VALUE 
;OF THE EXTERNAL SYMBOL 

; ASSUMING WE ARE IN THE ABSOLUTE 
; SECTION AND THE VALUE OF RELOCAT- 
;ABLE IS RELOCATABLE 40. 


005065' CLR EXTERNAL (5) 
000000 


005065' CLR EXTERNAL+6 ( 5) 
000006 


005065' CLR RELOCATABLE ( 5 ) 
000040 
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CHAPTER 7 


ADDRESSING 


The program counter (register 7 of the eight general registers) 
always contains the address of the next word to be fetched; i.e., 
the address of the next instruction to be executed, or the second or 
third word of the current instruction. 

In order to understand how the address modes operate and how 
they assemble, the action of the program counter must be understood. 
The key rule is ; 

Whenever the processor implicitly uses the program counter 
to fetch a word from memory, the program counter is 
automatically incremented by two after the fetch . 

That is, when an instruction is fetched, the PC is incremented 
by two, so that it is pointing to the next word in memory; and, if 
an instruction uses indexing (Sections 7.7, 7.8 and 7.10) the pro- 
cessor uses the program counter to fetch the base from memory. Hence, 
using the rule above, the PC increments by two, and now points to the 
next word. 

The following conventions are used in this section. 

a. Let E be any expression as defined in Chapter 4. 

b. Let R be a register expression. This is any expression 

containing a term preceded by a % character or a symbol 
previously equated to such a term. 

Examples : 

R^f = %0 ; GENERAL REGISTER 0 

R1 = R0+1 ; GENERAL REGISTER 1 

R2 = 1+%1 ; GENERAL REGISTER 2 

c. Let ER be a register expression or an expression in 
the range 0 to 7 inclusive. 

d. Let A be a general address specification which produces 
a 6-bit mode address field as described in Section I, 
Chapter 2 of the PDP-11 Handbook 1971 . 


7-1 



The addressing specifications, A, may now be explained in terms 
of E, R, and ER as defined above. Each will be illustrated with the 
single operand instruction CLR or double operand instruction MOV. 

7.1 REGISTER MODE 


The register contains the operand. 

; DEFINE RO AS REGISTER 0 
/CLEAR REGISTER 0 

7.2 DEFERRED REGISTER MODE 


Format: R 

Example: R0=%0 

CLR RO 


The register contains the address of the operand. 


Format: @R or (ER) 

Example: CLR @R1 

or 

CLR (1) 

7.3 AUTOINCREMENT MODE 


CLEAR THE WORD AT THE 
ADDRESS CONTAINED IN 
REGISTER 1 


The contents of the register are incremented immediately after being 
used as the address of the operand. (See note in Section 7.5) 


Format: 

(ER) + 


Examples : 

CLR 

(R0) + 


CLR 

(RO+3) + 


CLR 

(2) + 


CLEAR WORDS AT ADDRESSES CON- 
TAINED IN REGISTERS 0, 3 AND 2 
AND INCREMENT REGISTER CONTENTS 
BY TWO. 


NOTE 

Both JMP and JSR instructions using non-deferred 
autoincrement mode, autoinorement the register 
before its use. 
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In double operand instructions of the addressing 
form %R, (R)+ or %R,-(R) where the source and des- 
tination registers are the same ^ the source oper- 
and is evaluated as the autoincremented or auto- 
decremented value; but the destination register, 
at the time it is used, still contains the origi- 
nally intended effective address. For example, if 
Register 0 contains 100, the following occurs: 

MOV R0,(0)+ ;The quantity 102 is moved 

;to location 100 

MOV R0,-(0) ;The quantity 76 is moved 

;to location 76. 

The use of these forms should be avoided, as they 
are not guaranteed to remain in future PDP-11’ s. 


7.4 DEFERRED AUTOINCREMENT MODE 


The register contains the pointer to the address of the operand. The 
contents of the register are incremented after b eing used. 


Format: @(ER) + 

Example: CLR @(3)+ ; CONTENTS OF REGISTER 3 POINT TO 

; ADDRESS OF WORD TO BE CLEARED 
; BEFORE BEING INCREMENTED BY TWO. 

7.5 AUTODECREMENT MODE 


The contents of the register are decremented before being used as 
the address of the operand (see note at top of page) . 

Format: - (ER) 

Examples: CLR -(RO) ; DECREMENT CONTENTS OF REGISTERS 

CLR -(RO+3) ;0, 3, AND 2 BY TWO BEFORE USING 

CLR -(2) ;AS ADDRESSES OF WORDS TO BE 

; CLEARED. 

7.6 DEFERRED AUTODECREMENT MODE 

The contents of the register are decremented before being used as 
the pointer to the address of the operand. 

Format: @- (ER) 

Example: CLR @-(2) ;DECREMENT CONTENTS OF REG. 2 BY 

;TWO BEFORE USING AS POINTER TO 
; ADDRESS OF WORD TO BE CLEARED. 
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7.7 INDEX MODE 


Format: E (ER) 

The value of an expression E is stored as the second or third word 
of the instruction. The effective address is calculated as the value 
of E plus the contents of register ER. The value E is called the 
base . 


Examples : 

CLR X+2(R1) ;EFFECTIVE ADDRESS IS X+2 PLUS 

;THE CONTENTS OF REGISTER 1. 


CLR -2(3) ;EFFECTIVE ADDRESS IS -2 PLUS 

;THE CONTENTS OF REGISTER 3. 


7.8 DEFERRED INDEX MODE 

An expression plus the contents of a register gives the pointer to 
the address of the operand. 


Format: @E (ER) 

Example: CLR @14(4) 


IF REGISTER 4 HOLDS 100, AND 
LOCATION 114 HOLDS 2000, LOC. 
2000 IS CLEARED. 


7.9 IMMEDIATE MODE AND DEFERRED IMMEDIATE (ABSOLUTE) MODE 


The immediate mode allows the operand itself to be stored as the 
second or third word of the instruction. It is assembled as an 
autoincrement of register 7, the PC. 

Format: #E 

Examples: 

MOV #100, RO ;MOVE AN OCTAL 100 TO REGISTER 0 

MOV #X, RO ;MOVE THE VALUE OF SYMBOL X TO 

; REGISTER 0. 
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The operation of this mode is explained as follows: 

The statement MOV #100 /R3 assembles as two words. These are: 

0 1 2 7 0 3 
0 0 0 1 0 0 

Just before this instruction is fetched and executed, the PC 
points to the first word of the instruction. The processor fetches 
the first word and increments the PC by two. The source operand 
mode is 27 (autoincrement the PC) . Thus the PC is used as a pointer 
to fetch the operand (the second word of the instruction) before 
being incremented by two, to point to the next instruction. 

If the #E is preceded by @, E specifies an absolute address. 


7.10 RELATIVE AND DEFERRED RELATIVE MODES 


Relative mode is the normal mode for memory references. 


Format: 

E 



Examples : 

CLR 

100 

; CLEAR LOCATION 100 


MOV 

X,Y 

;MOVE CONTENTS OF LOCATION X TO 

; LOCATION Y. 


This mode is assembled as Index mode, using 7, the PC, as the 
register. The base of the address calculation, which is stored 
in the second or third word of the instruction, is not the address 
of the operand. Rather, it is the number which, when added to the 
PC, becomes the address of the operand. Thus, the base is X-PC. 

The operation is explained as follows: 

If the statement MOV 100, R3 is assembled at absolute location 
20 then the assembled code is: 

Location 20: 

Location 22 


0 1 6 7 0 3 
0 0 0 0 5 4 
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The processor fetches the MOV instruction and adds two to the PC 
so that it points to location 22. The source operand mode is 67; 
that is, indexed by the PC. To pick up the base, the processor 
fetches the word pointed to by the PC and adds two to the PC. 

The PC now points to location 24. To calculate the address of the 
source operand, the base is added to the designated register. That 
is, BASE+PC=54+24=100 , the operand address. 

Since the Assembler considers as the address of the first 

word of the instruction, an equivalent statement would be 

MOV 100 4 (PC) ,R3 

This mode is called relative because the operand address is calcu- 
lated relative to the current PC. The base is the distance (in 
bytes) between the operand and the current PC. If the operator and 
its operand are moved in memory so that the distance between the 
operator and data remains constant, the instruction will operate 
correctly . 

If E is preceded by @, the expression's value is the pointer 
to the address of the operand. 

7.11 TABLE OF MODE FORMS AND CODES 

Each instruction takes at least one word. Operands of the first 
six forms listed below, do not increase the length of an instruc- 
tion. Each operand in one of the other modes, however, increases 
the instruction length by one word. 


Form 

Mode 

Meaning 


R 

On 

Register 


@R or (ER) 

In 

Register deferred 

(ER) + 

2n 

Autoincrement 


@ (ER) + 

3n 

Autoincrement 

deferred 

-(ER) 

4n 

Autodecrement 


@- (ER) 

5n 

Autodecrement 

deferred 


None of the above forms increases the instruction length. 
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E (ER) 

6n 

Index 

@E (ER) 

7n 

Index deferred 

#E 

27 

Immediate 

@#E 

37 

Absolute memory reference 

E 

67 

Relative 

@E 

77 

Relative deferred reference 

30ve forms adds 

a word to 

the instruction length. 


NOTES 



1. An alternate form for @R is (ER) . However, the 
form @ (ER) is equivalent to @0 (ER) . 


2. The form @#E differs from the form E in that 
the second or third word of the instruction 
contains the absolute address of the operand 
rather than the relative distance between the 
operand and the PC. Thus, the instruction CLR @#100 
will clear location 100 even if the instruction is 
moved from the point at which it was assembled. 


7.12 INSTRUCTION FORMS 

The instruction mnemonics are given in Appendix B. This section 
defines the number and nature of the operand fields for these 
instructions . 

In the table that follows, let R, E, and ER represent expres- 
sions as defined on page 7-1, and let A be a 6-bit address speci- 
fication of any one of the forms: 

E @E 

R @R or (R) 

(ER)+ @(ER) + 

-(ER) @-(ER) 

E(ER) @E(ER) 

#E @#E 


Table 2.1 Instruction Operand Fields 


Instruction 


Form 

Example 

Double Operand 


Op A, A 

MOV (R6)+,@Y 

Single Operand 


Op A 

CLR - (R2) 

Operate 


Op 

HALT 

Branch 


Op E 

BR X+2 




BLO .-4 


where 

-128< (E-.-2)/2£l27^Q 


Subroutine Call 


JSR ER,A 

JSR PC,SUBR 

Subroutine Return 


RTS ER 

RTS PC 

EMT/TRAP 


Op or OP E 

EMT 


where 

0_<EO77g 

EMT 31 
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The branch instructions are one word instructions. The high 
byte contains the op code and the low byte contains an 8-bit signed 
offset (7 bits plus sign) which specifies the branch address rela- 
tive to the PC. The hardware calculates the branch address as fol- 
lows : 

a) Extend the sign of the offset through bits 8-15. 

b) Multiply the result by 2. This creates a word 
offset rather than a byte offset. 

c) Add the result to the PC to form the final branch 
address . 

The Assembler performs the reverse operation to form the 
byte offset from the specified address. Remember that when the 
offset is added to the PC, the PC is pointing to the word follow- 
ing the branch instruction; hence the factor -2 in the calculation. 

Byte offset = (E-PC)/2 truncated to eight bits. 

Since PC = .+2, we have 

Byte offset = (E-.-2)/2 truncated to eight bits. 

NOTE 

It is illegal to branch to a location specified 
as an external symbol/ or to a relocatable symbol 
when within an absolute section, or to an absolute 
symbol or a relocatable symbol of another program 
section when within a relocatable section. 

The EMT and TRAP instructions do not use the low-order byte 
of the word. This allows information to be transferred to the 
trap handlers in the low-order byte. If EMT or TRAP is followed by 
an expression, the value is put into the low-order byte of the word. 
However, if the expression is too big (>377g) it is truncated to 
eight bits and a Truncation (T) error occurs. 
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CHAPTER 8 


ASSEMBLER DIRECTIVES 

Assembler directives (sometimes called pseudo-ops) direct the 
assembly process and may generate data. 

Assembler directives may be preceded by a label and followed 
by a comment. The assembler directive occupies the operator field 
Only one directive may be placed in any one statement. One or more 
operands may occupy the operand field or it may be void — allow- 
able operands vary from directive to directive. 

8.1 .TITLE 


The .TITLE directive is used to name the object module. The 
name assigned is the first symbol following the directive. If there 
is no .TITLE statement the default name assigned is ".MAIN.". If 
there is more than one .TITLE directive, only the last one encountered 
is operative. 

8.2 . GLOBL 

The .GLOBL directive is used to declare a symbol as being global, 
This is the mechanism by which separately assembled object modules com- 
municate with one another. it may be an entry symbol in which case 
it is defined in the program or it may be an external symbol in which 
case it should be defined in another program which will be linked 
with this program by Link-11. 

The form of the .GLOBL directive is 

. GLOBL NAMA ,NAMB , . . . ,NAMN 

NOTE 

A symbol cannot be declared global by assigning it 
to a global expression in a direct assignment state- 
ment. 
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8.3 PROGRAM SECTION DIRECTIVES 


.ASECT 

.CSECT 

.CSECT symbol 

The Assembler provides for 255 j^q program sections; an absolute 
section declared by .ASECT, an unnamed relocatable program sec- 
tion declared by .CSECT, and 253^^ named relocatable program sec- 
tions declared by .CSECT symbol, where symbol is any legal symbolic 
name. These directives allow the user to; 


1. Create his program (object module) in sections; 


The Assembler maintains separate location counters for 
each section. This allows the user to write statements which 
are not physically contiguous but will be loaded contiguously. 
The following examples will clarify this; 


.CSECT 
A: 0 

B; 0 
C: 0 

ST: CLR A 
CLR B 
CLR C 
.ASECT 
.=4 

.WORD .+2, HALT 
.CSECT 

INC A 
BR ST 
.END 


START THE UNNAMED RELOCATABLE SECTION 
ASSEMBLED AT RELOCATABLE 0, 
RELOCATABLE 2 AND 
RELOCATABLE 4, 

ASSEMBLE CODE AT 

RELOCATABLE ADDRESS 
6 THROUGH 21 

START THE ABSOLUTE SECTION 
ASSEMBLE CODE AT 
ABSOLUTE 4 THROUGH 7, 

RESUME THE UNNAMED RELOCATABLE 
SECTION 

ASSEMBLE CODE AT 

RELOCATABLE 22 THROUGH 27, 


The 'first appearance of .CSECT or .ASECT assumes the location 
counter is at relocatable or absolute zero, respectively. The 
scope of each directive extends until a directive to the con- 
trary is given. Further occurrences of the same .CSECT or 
.ASECT resume assemblying where the section was left off. 
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CSECT 

1 

COMl 

1 

CSECT 

1 

COM2 

1 

CSECT 

COMl 

END 



DECLARE SECTION COMl 
ASSEMBLED AT RELOCATABLE 0, 
ASSEMBLED AT RELOCATABLE 2 , 
ASSEMBLED AT RELOCATABLE 4, 
DECLARE SECTION COM2 
ASSEMBLED AT RELOCATABLE 0, 
ASSEMBLED AT RELOCATABLE 2, 
RETURN TO COMl 
ASSEMBLED AT RELOCATABLE 6, 


The Assembler automatically begins assemblying at relocatable 
zero of the unnamed .CSECT if not instructed otherwise; that 
is, the first statement of an assembly is an implied .CSECT. 


All labels in an absolute section are absolute; all 
labels in a relocatable section are relocatable. The location 
counter symbol, is relocatable or absolute when refer- 

enced in a relocatable or absolute section, respectively. 
Undefined internal symbols are assigned the value of relocat- 
able or absolute zero in a relocatable or absolute section, 
respectively. Any labels appearing on a .ASECT or .CSECT state- 
ment are assigned the value of the location counter before the 
.ASECT or .CSECT takes effect. Thus, if the first statement of a 
program is ; 

A: .ASECT 


Then A is assigned to relocatable zero and is associated with 
the unnamed relocatable section (because the Assembler im- 
plicitly begins assembly in the unnamed relocatable section) . 

Since it is not known at assembly time where the program 
sections are to be loaded, all references between sections in a 
single assembly are translated by the Assembler to references- 
relative to the base of that section. The Assembler provides 
the Linker with the necessary information to resolve the linkage. 
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Note that this is not necessary when making a reference to an 
absolute section (the Assembler knows all load addresses of an 
absolute section) . 


Examples : 

.ASECT 
.=1000 
A: CLR X 

JMP Y 

.CSECT 
MOV R0,R1 
JMP A 
Y : HALT 

X: 0 

.END 


; ASSEMBLED AS CLR BASE OF UNNAMED 
; RELOCATABLE SECTION +10 
; ASSEMBLED AS JMP BASE OF UNNAMED 
; RELOCATABLE SECTION + 6 


; ASSEMBLED AS JMP 1000 


In the above example the references to X and Y were trans- 
lated into references relative to the base of the unnamed 
relocatable section. 


2. Share code and/or data between object modules (separate as- 
semblies) : 


Named relocatable program sections operate as Fortran 
labeled COMMON; that is, sections of the same name from dif- 
ferent assemblies are all loaded at the same location by 
Link-11. The unnamed relocatable section is the exception to 
this as all unnamed relocatable sections are loaded in unique 
areas by Link-11. 

Note that there is no conflict between internal sym- 
bolic names and program section names; that is, it is legal 
to use the same symbolic name for both purposes. In fact, 
considering Fortran again, this is a necessity to accommo- 
date the Fortran statement 

COMMON /X/A,B,C,X 

Where the symbol X represents the base of this program section 
and also the 4th element of this program section. 
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Also, there is no conflict between program section names and 
. GLOBL names. In FORTRAN language, COMMON block names and SUB- 
ROUTINE names may be the same. 

8.4 .EOT 

Under the Disk Operating System, the .EOT directive is effectively 
ignored. The physical End Of Tape itself allows several physically 
separate tapes to be assembled as one program. The last tape should 
be terminated by a .END directive; however, in its absence, the TAPES 
command string switch (Section 9.3) may be used. 

8.5 .EVEN 


The .EVEN directive ensures that the assembly location counter is 
even by adding one if it is odd. Any operands following a .EVEN 
directive will be ignored. 

8.6 .END 

The .END directive indicates the physical end of the source pro- 
gram. The .END directive may be followed by only one operand, an 
expression indicating the program's transfer address. 

At load time, the load module will be loaded and program ex- 
ecution will begin at the transfer address indicated by the .END 
directive. If the address is not specified, the loader will halt 
after reading in the load module. 

8.7 .WORD 

The .WORD assembler directive may have one or more operands, 
separated by commas. Each operand is stored in a word of the ob- 
ject program. If there is more than one operand, they are stored 
in successive words. The operands may be any legally formed expres- 
sion. For example: 
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.=1420 

SAL=0 

.WORD 177535, .+4, SAL ;STORED IN WORDS 1420, 1422, AND 

;1424 WILL BE 177535, 1426, AND 0. 

Values exceeding 16 bits will be truncated from the left to 
word length. 

A .WORD directive followed by one or more void operands sep- 
arated by commas will store zeros for the void operands. For ex- 
ample , 

.=1430 ;ZERO, FIVE, AND ZERO ARE STORED 

.WORD ,5, ;IN WORDS 1430, 1432, AND 1434. 

An operator field left blank will be interpreted as the .WORD 
directive if the operand field contains one or more expressions. 

The first term of the first expression in the operand field must 
not be an instruction mnemonic or assembler directive unless pre- 
ceded by a +, -, or one of the logical operators, ! or & . For 
example, 

.=440 ;THE OP -CODE FOR MOV, WHICH 

; IS 010000, 

LABEL: +MOV, LABEL ;IS STORED IN LOCATION 440. 440 IS 

; STORED IN LOCATION 442. 

Note that the default .WORD will occur whenever there is a 
leading arithmetic or logical operator, or whenever a leading sym- 
bol is encountered which is not recognized as an instruction 
mnemonic or assembler directive. Therefore, if an instruction 
mnemonic or assembler directive is misspelled, the .WORD directive 
is assumed and errors will result. Assume that MOV is spelled incor 
rectly as MOR: 

MOR A,B 

Two error codes can result: Q will occur because an expression 

operator is missing between MOR and A, and a U will occur if MOR is 
defined. Two words will be generated: one for MOR A and one for B. 


un- 
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8.8 . BYTE 


The .BYTE assembler directive may have one or more operands separ- 
ated by commas. Each operand is stored in a byte of the object 
program. If multiple operands are specified, they are stored in 
successive bytes. The operands may be any legally formed expression 
with a result of 8 bits or less. For example: 

SAM=5 /STORED IN LOCATION 410 WILL BE 

.=410 ;060 (THE OCTAL EQUIVALENT OF 48). 

.BYTE 48., SAM ; IN 411 WILL BE 005. 

If the expression has a result of more than 8 bits, it will be 
truncated to its low-order 8 bits and will be flagged as a T error. 
If an operand after the .BYTE directive is left void, it will be 
interpreted as zero. For example: 

.=420 /ZERO WILL BE STORED IN 

.BYTE , , /BYTES 420, 421 and 422. 

If the expression is relocatable, a warning flag, A, will be given, 
since at link time it is very likely that the relocation will result 
in an expression of more than 8 bits. 

8.9 .ASCII 


The .ASCII directive translates strings of ASCII characters into 
their 7-bit ASCII codes, with the exception of null, rubout, car- 
riage return, line feed, and form feed. The text to be translated 
is delimited by a character at the beginning and the end of the 
text. The delimiting character may be any printing ASCII character 
except colon and equal sign and those used in the text string. 

The 7-bit ASCII code generated for each character will be stored 
in successive bytes of the object program. For example: 


. = 500 

.ASCII /YES/ 


/THE ASCII CODE FOR "Y" WILL BE 
/STORED IN 500, THE CODE FOR "E" 
/IN 501, THE CODE FOR "S" IN 502. 


.ASCII /5+3/2/ 


THE DELIMITING CHARACTER OCCURS 
AMONG THE OPERANDS. THE ASCII 
CODES FOR "5", "+", AND "3" ARE 
STORED IN BYTES 503,504, AND 
505. 2/ IS NOT ASSEMBLED. 


The .ASCII directive may be terminated by any legal terminator. 
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8.10 .RAD50 


PDP-11 systems programs often handle symbols in a specially coded 
form called RADIX 50 (this form is sometimes referred to as 
MOD40 ) . This form allows 3 characters to be packed into 16 
bits; therefore, any 6-character symbol can be held in two words. The 
form of the directive is: 

.RAD 50 /CCC/ 

The single operand is of the form /CCC/ where the slash (the delimiter) 
can be any printable character except for = and : . The de- 
limiters enclose the characters to be converted which may be 
A through Z, 0 through 9, dollar ($) , dot (.) and space ( ). 

If there are fewer than 3 characters they are considered to be 
left justified and trailing spaces are assumed. 

Examples ; 

.RAD50 /ABC/ ;PACK ABC INTO ONE WORD 

.RAD50 /AB/ ;PACK AB (SPACE) INTO ONE WORD 

.RAD50 // ;PACK 3 SPACES INTO ONE WORD 

The packing algorithm is as follows: 

A. Each character is translated into its RADIX 50 equivalent as 
indicated in the following table: 

Character RADIX 50 Equivalent (octal ) 

(space) 0 

A-Z 1-32 

$ 33 

34 

0-9 36-47 

Note that another character could be defined for code 35. 

B. The RADIX 50 equivalents for characters 1 through 3 (C1,C2,C3) 
are combined as follows: 

RESULT=( (Cl*50)+C2) *50+C3 
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8.11 .LIMIT 


A program often wishes to know the boundaries of the load module's 
relocatable code. The .LIMIT directive generates two words into 
which the Linker puts the low and high addresses of the relocated 
code. The low address (inserted into the first word) is the address 
of the first byte of code. The high address is the address of the 
first free byte following the relocated code. These addresses will 
always be even since all relocatable sections are loaded at even 
addresses and if a relocatable section consists of an odd number 
of bytes the Linker adds one to the size to make it even. 

8.12 CONDITIONAL ASSEMBLY DIRECTIVES 


Conditional assembly directives provide the programmer with 
the capability to conditionally include or not include portions of 
his source code in the assembly process. In what follows, E denotes 
an expression and S(I) denotes a symbol. The conditonal directives 
are : 


IFZ 

E 





IF 

E=0 

IFNZ 

E 





IF 

Ej^O 

IFL 

E 





IF 

E<0 

IFLE 

E 





IF 

E<0 

IFG 

E 





IF 

E>0 

IFGE 

E 





IF 

E^O 

IFDF 

S 

(1) 

[! 

,&]S (2) 

[ 

1/&] 

• • • 

IFNDF 

S 

(1) 

[1 

,&]S (2) 

[ 

! ,&] 

• • * 


( !=OR,&=AND) 


If the condition is met, all statements up to the matching .ENDC are 
assembled. Otherwise, the statements are ignored until the matching 
.ENDC is detected. 


In the above, .IFDF and .IFNDF mean "if defined" and "if un- 
defined" respectively. The scan is left to right, no parentheses 
permitted. 


Example: 

.IFDF SIT&U Means assemble if either S or T is defined 
and U is defined 

.IFNDF T&UIS Means assemble if both T and U are undefined 
or if S is undefined 
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General Remarks: 


An errored or null expression takes the default value 0 for 
purposes of the conditional test. An error in syntax, e.g., 
a terminator other than !, &, or CR results in the undefined 
situation for .IFDF and .IFNDF, as does an errored or null symbol. 

All conditionals must end with the .ENDC directive. Anything in 
the operand field of .ENDC is ignored. Nesting is permitted 
up to a depth of 1272 ^q. Labels are perttiitted on conditional 
directives, but the scan is purely left to right. For example: 

.IFZ 1 

A: .ENDC 


A is ignored. 


A: .IFZ 1 

.ENDC 

A is entered in the symbol table. 

If an .END is encountered while inside a satisfied conditional, 
a Q flag will appear, but the .END directive will still be pro- 
cessed normally. If more .ENDC's appear than are required, Q flags 
appear on the extras . 
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CHAPTER 9 


OPERATING PROCEDURES 

The Assembler enables you to assemble into a relocatable binary 
file (object module) an ASCII source containing PAL-llR statements. 
To do this, two or three passes are necessary. On the first pass, 
the Assembler creates a table of user-defined symbols and their 
associated values, and a list of undefined symbols is printed on 
the command output device. On subsequent passes the Assembler assem- 
bles the program and produces the outputs specified during the ini- 
tial dialogue (Section 9.2). The Assembler initiates the dialogue 
immediately after being loaded and after the last pass of an assem- 
bly. 

9.1 LOADING PAL-llR 

PAL-llR is loaded via the Disk Monitor command RUN. For example: 

RUN PALllR 

9.2 INITIAL DIALOGUE 

When the Assembler is ready to accept the user's command string, it 
outputs the following lines to the command device: 

PALllR V002A 


The user must now type his command string on the same line as the 

#. 

If an error is made in typing at any time, typing the RUBOUT 
key will erase the immediately preceding character if it is on the 
current line. Typing CTRL/U will erase the entire line. 

The format of the command string adheres to the requirements 
of the Disk Operating System's (DOS) Command String Interpreter 
(CSI) . The Assembler's file specifications must appear in the 
following order: 
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# Binary, Listing, Symbol Table < Source 1, Source 2 

A null specification field signifies that the associated input or out- 
put type is not desired. Each specification contains the following 
information : 

dev: f ilnam. ext [uic] /PASS : value/TAPES rvalue 

If a syntactical error is detected in the command string, the 
Assembler will output the command string up to and including the point 
where the error was detected followed by the character The 

Assembler will then output # again, and the user must retype his 
entire command. 

The following command string semantic errors will be detected: 

Error Code 


1. Illegal switch S203 

Too many switches 

Illegal switch value 
Too many switch values 

2. Too many output file specifications S204 

3. Too many input file specifications S205 

4. Input file missing S206 


After outputting the appropriate error code, the Assembler will 
output # again and the user must retype his entire command. 

The default value for each specification is noted below: 



DEV 

FILNAM 

EXT 

UIC 


PASS 

TAPES 

Source 1 

DFO 

None 

PAL 

This 

User 

All 

Passes*** 

1 

Source 2 

DFO* 

None 

PAL 

This 

User 

All 

Passes 

1 

Binary 

DFO 

Same as 

Source** 

FILNAM 

OBJ 

This 

User 


2 


Listing 

DFO* 

Same as 

Source** 

FILNAM 

LST 

This 

User 


2 


Symbols 

DFO* 

Same as 

SYM 

This 

User 

End 

of Pass 1 



Source** 
F ILNAM 


* Or last device specified on this side of the <. 

** The default FILNAM is Source 2's if this field is present; other- 
wise, Source I's is used. 

*** If /PASS:n (where 0<n<4) is in the Source 1 field, this file 

will only be accessed during pass 1. This is useful for param- 
eter assignments associated with conditional assemblies. 
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Source 1 and Source 2 cannot both be associated with the same unit file 
device such as the paper tape reader. This will result in a Monitor 
error. 

The TAPES switch is recognized in the two input fields of 
PAL-llR's command string; it is ignored in the output fields. The 
value associated with the switch specifies the maximum decimal num- 
ber of tapes* that will be processed from the designated device. 

The .END assembly directive always terminates an assembly pass; how- 
ever, if it is missing, the maximum tape count will effect 
termination. In the latter case, the error line count output by the 
Assembler is incremented by one to warn the user of the omission. The 
default number of tapes is 1. The following examples should clarify the 
usages of the TAPES switch. 

1. #PP: ,LP: ,LP:<PR:/TAPES:5 

All passes of the assembly will terminate either when a) the 
.END directive is encountered or b) five tapes have been in- 
put from the reader. 

2. #PP:,LP:<PR: 

All passes of the assembly will terminate when one tape has 
been input from the reader. 

3 . #PP : <PR : /PASS : 1/TAPES : 2 , DTI ; FILE 

Two parameter tapes will be input from the reader during 
pass 1 only . All passes of the assembly will terminate 
either when a) the .END directive is encountered or b) the 
source file FILE. PAL has been input from DTI. 

4. #PP:<DT1:PARAM/PASS:1,PR:/TA:4 

One parameter file, PARAM.PAL, will be input from DTI during 
pass 1 only . All passes of the assembly will terminate 
either when a) the .END directive is encountered or b) four 
tapes have been input from the reader. 


* This switch is most applicable to non-file oriented devices such as 
the paper tape reader. However, it would cause the same file on 
DECtape to be processed the specified number of times during each 
pass. 
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The 37 switch is recognized in all the fields of PAL-llR's command 
string. Its presence directs the Assembler to assemble all relative 
addresses (address mode 67) as absolute addresses (address mode 37) . 

e.g., CLR ADDR normally assembles as 

0050£7 

N 

where N is the offset between ADDR and 

the current PC. 

When the 37 switch has been encountered in the 
command string 

CLR ADDR assembles as 

005022 

ADDR 

just as if the source code read 

CLR @#ADDR 

This switch is useful during the debugging phase of program devel- 
opment as it facilitates tracing through assembly listings. Note that 
when the 37 switch is used, position independent coding is not possible. 

The following example command string shows the 37 switch specifi- 
cation 

#PP : , LP : /3 7 <DT1 : FILE 


Note that DOS only allows one output file to be open on a DEC tape 
at a time. The Assembler loosens this restriction by: 

1. Providing the PASS switch, for example: 

#DTA1 : , DTAl : /PASS : 3 <TEST 

This command causes the input file TEST. PAL on DFO to be 
assembled with binary output, TEST. OBJ, to DTAl during 
pass 2 and listing output, TEST.LST, to DTAl during pass 3. 

2. Closing files and releasing datasets^ as soon as possible, 

for example: 

# , DTAl : , DTAl : /PASS : 2 <TEST 


1 The releasing of datasets has the additional advantage that all 
drivers and buffers do not have to be core resident during the 
entire assembly. 
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This command causes the input file TEST. PAL on DFO to be 
assembled with no binary outout, listing output, TEST.LST 
to DTAl during pass 2 and symbol table output, TEST.SYM to 
DTAl at the end of pass 2. 

The symbol table is output alphabetically, three symbols per 
line. Each symbol is output in the following format: 


SYMBOL 


R G 


If direct 
assignment 



V. 


value 


j 



If register • 


If J 

relocatable -* 


oCSECT ID 


If oGLOBL— * 


If the symbol is undefined, six asterisks replace its value. 
The identifying characters indicate the class of the symbol; that 
is, whether it is a label, direct assignment, register symbol, 
relocatable, absolute, or global. 


The .CSECT ID field is left blank for .ASECT symbols and un- 
named .CSECT symbols as they can be identified by the absence or 
presence of the R , respectively. 


Symbols belonging to named .CSECT 's have the ID's 002 through 
376 o associated with them, where the nth named .CSECT encountered 

O 

will have the ID n+1. 


Immediately following the symbol table listing will be a listing 
of the .CSECT names, their sizes in bytes, and their corresponding ID's. 
There will be one entry per line in the following format; 

FIRST i2(j2f4020 002 

SECOND 000376 003 


When no outputs are omitted and the default passes are in 
effect, the Assembler performs as follows: 
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PASS 1: 


Assembler creates a table of user-defined symbols and 
their associated values to be used in assembling the 
source to object program. Undefined symbols (not in- 
cluding external .GLOBL's) are listed on the command 
output device at the end of the pass. The symbol 
table is also output at this time. 

PASS 2: Assembler outputs the object module, and the listing 

file which includes the pass error line count (in 
octal) , and prints the pass error line count on the 
command output device. 

9.3 ASSEMBLY DIALOGUE 

During assembly, the Assembler may output various messages to the 
command device. The message may be; 

1. informative, 

2. request for operator action, or 

3. terminal. 

The operator may also initiate a message. For example, CTRL/C and 
RESTART at any time, to stop the assembly process and restart the 
initial dialogue as mentioned in the previous section. 

At the end of each pass (except the last) when the .END 
assembly directive is encountered, END is output to the command 
device. For file structured input devices, the next pass is auto- 
matically begun. For non-file structured input devices, e.g., paper 
tape reader, the Disk Operating System will announce that the reader 
must be reloaded prior to continuing: 

A002 063320 

$ 

A002 denotes device not ready, and 
063320 is the radix 50 notation for PR. 

After the user has reloaded the reader, he should type 
CTRL/C (tC) on the command input device. When the monitor acknow- 
ledges with the character . , the user should type the monitor 
command CONTINUE. 
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This continuing from device-not-ready is also applicable when .EOT 
is encountered during multiple tape assemblies and when any I/O 
device requires servicing for such purposes as: 

a. line printer paper 

b. write enable DECtape 

c. tape for punch. 

The following terminal errors are printed on the command device. 
An attempt is made to close all output files and delete the binary 
file, if open. The Assembler then outputs # and waits for further 
commands : 

5200 more than 376 „ .CSECT's 

O 

5201 more than 177g nested conditionals 

5202 binary or listing file structured device full 
or input command string too long 

S207 input .TRAN error on Assembler's overlay file 

RESTART capability: 

The assembly may be aborted at any time by typing CTRL/C followed by 
either the Monitor command RESTART or the Monitor command BEGIN on the 
command device. All open output files will be closed and released. 

If the binary file was open, it is deleted. The Assembler will output 
# and wait for the next command string. It does this automatically at 
the normal completion of an assembly. 

9 . 4 ASSEMBLY LISTING 

The PAL-llR Assembler produces a side-by-side assembly listing of 
symbolic source statements, their octal equivalents, assigned 
addresses, and error codes, as follows: 

EELLLLLL ’OOOOOOASSS S 

000000 

000000 

The E's represent the error field. The L's represent the address. 

The O's represent the object data in octal. The S's represent the 
source statement. The A represents an apostrophe which indicates 
that either the second, third, or both words of the instruction are 
to be modified by the Linker. 
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The above represent a three-word statement. The second and 
third words of the statement are listed under the command word. 

No addresses precede the second and third words since the address 
order is sequential. 

The third line is omitted for a two-word statement; both 
second and third lines are omitted for a one-word statement. 

For a. BYTE directive, the object data field is three octal 
digits . 

For a direct assignment statement, the value of the defining 
expression is given in the object code field although it is not 
actually part of the code of the object program. 

The .ASECT and .CSECT directives cause the current value of 
the appropriate location counter (absolute or relocatable) to be 
printed . 

Each page of the listing is headed by a page number (octal) . 
9.5 OBJECT MODULE OUTPUT 

The output of the Assembler during the binary object pass is an 
object module which is meaningful only to the Linker. What fol- 
lows gives an overview of what the object module contains and at 
what stage each part of it is produced. 

The binary object module consists of three main types of data 
block; 


a) 

Global symbol 

directory 

(GSD) 

b) 

Text blocks 


(TXT) 

c) 

Relocation Directory 

(RLD) 

.1 

Global Symbol 

Directory 



As the name suggests, the Global Symbol Directory (GSD) contains 
a list of all global symbols (entry points and externals) with 
all entry points associated with the program section symbol in 
which they reside. Each symbol is in RADIX 50 form and contains 
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mode information and relative addresses for entry points, and section 
sizes for program section names. The name of the object module is 
also in the GSD. 

The GSD is created at the start of the binary object pass. 

9.5.2. Text Block 

The text blocks consist entirely of the binary object data as 
shown in the listing. The operands are in the unmodified form. 

9.5.3 Relocation Directory 

The Relocation Directory (RLD) blocks consist of directives to 
the Linker which may reference the text block preceding it. These 
directives control the relocation and linking process. 

Text and RLD blocks are constructed during the binary object 
pass. Outputting of each block is done whenever either the Text 
or RLD buffer is full and whenever the location counter needs 
to be modified. 
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CHAPTER 10 


ERROR CODES 


The error codes printed beside the octal and symbolic code in 
the assembly listing have the following meanings: 


Error Code 


A 


D 


I 


M 


N 

P 

Q 


R 

T 


U 


Meaning 

Addressing error. An address within the in- 
struction is incorrect. Also may indicate a 
relocation error. 

Bounding error. Instructions or word data are 
being assembled at an odd address in .memory. 

The location counter is updated by +1. 

Doubly-defined symbol referenced. Reference 
was made to a symbol which is defined more 
than once . 

]^llegal character detected. Illegal characters 
which are also non-printing are replaced by a 
? on the listing. 

Line buffer overflow. Extra characters on a 
line (more than 72^^) are ignored. 

Multiple definition of a label. A label was 
encountered which was equivalent (in the first 
six characters) to a previously encountered 
label. 

Number containing 8 or 9 has decimal point 
missing. 

Phase error. A label's definition or value 
varies from one pass to another. 

Q^uestionable syntax. There are missing argu- 
ments or the instruction scan was not completed 
or a carriage return was not immediately fol- 
lowed by a line feed or form feed. 

Register-type error. An invalid use of or ref- 
erence to a register has been made. 

Truncation error. A number generated more than 
16 bits of significance or an expression gen- 
erated more than 8 bits of significance during 
the use of the .BYTE directive. 

Undefined symbol. An undefined symbol was en- 
countered during the evaluation of an expres- 
sion. Relative to the expression, the unde- 
fined symbol is assigned a value of zero. 
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APPENDIX A 


ASCII CHARACTER SET 


EVEN 

PARITY 

BIT 

7-BIT 

OCTAL 

CODE 

CHARACTER 

0 

000 

NUL 

1 

001 

SOH 

1 

002 

STX 

0 

003 

ETX 

1 

004 

EOT 

0 

005 

ENQ 

0 

006 

ACK 

1 

007 

BEL 

1 

010 

BS 

0 

011 

HT 

0 

012 

LF 

1 

013 

VT 

0 

014 

FF 

1 

015 

CR 

1 

016 

SO 

0 

017 

SI 

1 

020 

DLE 

0 

021 

DCl 

0 

022 

DC 2 

1 

023 

DC 3 

0 

024 

DC 4 

1 

025 

NAK 

1 

026 

SYN 

0 

027 

ETB 

0 

030 

CAN 

1 

031 

EM 

1 

032 

SUB 

0 

033 

ESC 

1 

034 

FS 


REMARKS 


NULL, TAPE FEED, CONTROL SHIFT P. 

START OF HEADING; ALSO SOM, START OF MESSAGE 
CONTROL A. 

START OF TEXT; ALSO EOA, END OF ADDRESS, 
CONTROL B. 

END OF TEXT; ALSO EOM, END OF MESSAGE, CON- 
TROL C . 

END OF TRANSMISSION (END) ; SHUTS OFF TWX 
MACHINES, CONTROL D. 

ENQUIRY (ENQRY) ; ALSO WRU, CONTROL E. 
ACKNOWLEDGE; ALSO RU, CONTROL F. 

RINGS THE BELL. CONTROL G. 

BACKSPACE; ALSO FEO, FORMAT EFFECTOR. BACK- 
SPACES SOME MACHINES, CONTROL H. 

HORIZONTAL TAB. CONTROL I. 

LINE FEED OR LINE SPACE (NEW LINE) ; ADVANCES 
PAPER TO NEXT LINE, DUPLICATED BY CONTROL J. 
VERTICAL TAB (VTAB) . CONTROL K. 

FORM FEED TO TOP OF NEXT PAGE (PAGE) . CON- 
TROL L . 

CARRIAGE RETURN TO BEGINNING OF LINE. DUPLI 
GATED BY CONTROL M. 

SHIFT OUT; CHANGES RIBBON COLOR TO RED. CON 
TROL N. 

SHIFT IN; CHANGES RIBBON COLOR TO BLACK. 
CONTROL O. 

DATA LINK ESCAPE. CONTROL P (DC)2f) . 

DEVICE CONTROL 1, TURNS TRANSMITTER (READER) 
ON, CONTROL Q (X ON) . 

DEVICE CONTROL 2, TURNS PUNCH OR AUXILIARY 
ON. CONTROL R (TAPE, AUX ON) . 

DEVICE CONTROL 3, TURNS TRANSMITTER (READER) 
OFF, CONTROL S (X OFF) . 

DEVICE CONTROL 4, TURNS PUNCH OR AUXILIARY 
OFF. CONTROL T ( TAPE , AUX OFF) . 

NEGATIVE ACKNOWLEDGE; ALSO ERR, ERROR. CON- 
TROL U. 

SYNCHRONOUS IDLE (SYNC) . CONTROL V. 

END OF TRANSMISSION BLOCK; ALSO LEM, LOGICAL 
END OF MEDIUM. CONTROL W. 

CANCEL (CANCL) . CONTROL X. 

END OF MEDIUM. CONTROL Y. 

SUBSTITUTE. CONTROL Z. 

ESCAPE. PREFIX. CONTROL SHIFT K. 

FILE SEPARATOR. CONTROL SHIFT L. 
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EVEN 7-BIT 

PARITY OCTAL 

BIT CODE CHARACTER 


0 167 w 

0 170 X 

1 171 y 

1 172 z 

0 173 { 

1 174 I 
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APPENDIX B 


PAL-llA ASSEMBLY LANGUAGE AND ASSEMBLER 


B.l SPECIAL CHARACTERS 

Character Function 


form feed 
line feed 
carriage return 


% 

tab 

space 

# 

(i 

( 


+ 

& 

I 


Source line terminator 

Source line terminator 

Source statement terminator 

Label terminator 

Direct assignment indicator 

Register term indicator 

Item terminator 
Field terminator 

Item terminator 
Field terminator 

Immediate expression indicator 

Deferred addressing indicator 

Initial register indicator 

Terminal register indicator 

Operand field separator 

Comment field indicator 

Arithmetic addition operator 

Arithmetic subtraction operator 

Logical AND operator 

Logical OR operator 

Double ASCII character indicator 

Single ASCII character indicator 

Assembly location counter 
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B.2 ADDRESS MODE SYNTAX 


n is an integer between 0 and 7 representing a register. R is a register 


expression, E 

expression in 

is an expression, ER 
the range 0 to 7 . 

is either 

a register expression or an 

Format 

Address 

Mode 

Name 

Address 

Mode 

Number 

Meaning 

R 

Register 

On 

Register R contains the op- 
erand. R is a register ex- 
pression . 

@R or (ER) 

Deferred Register 

In 

Register R contains the op- 
erand address. 

(ER) + 

Autoincrement 

2n 

The contents of the regis- 
ter specified by ER are in- 
cremented after being used 
as the address of the oper- 
and . 

@ (ER)+ 

Deferred Auto- 
increment 

3n 

ER contains the pointer to 
the address of the operand. 

ER is incremented after use. 

- (ER) 

Autodecrement 

4n 

The contents of register ER 
are decremented before being 
used as the address of the 
operand . 

(ER) 

Deferred Auto- 
decrement 

5n 

The contents of register ER 
are decremented before being 
used as the pointer to the 
address of the operand. 

E (ER) 

Index 

6n 

E plus the contents of the 
register specified, ER, is 
the address of the operand. 

@E (ER) 

Deferred Index 

7n 

E added to ER gives the point 
er to the address of the oper 
and . 

#E 

Immediate 

27 

E is the operand. 

@#E 

Absolute 

37 

E is the address of the oper- 
and. 

E 

Relative 

67 

E is the address of the oper- 
and . 

@E 

Deferred Relative 

77 

E is the pointer to the ad- 


dress of the operand. 
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B.3 INSTRUCTIONS 


The instructions which follow are grouped according to the operands they 
take and the bit patterns of their op-codes . 

In the representation of op-codes, the following symbols are used; 

Source operand specified by a 6-bit address 
mode . 

Destination operand specified by a 6-bit ad- 
dress mode. 

8-bit offset to a location (branch instruc- 
tions) 

Integer between 0 and 7 representing a general 
register. 

Symbols used in the description of instruction operations are: 

SE Source Effective address 

DE Destination Effective address 

{ ) Contents of 

^ Becomes 

The condition codes in the processor status word (PS) are affected by 
the instructions. These condition codes are represented as follows: 


SS 

DD 

XX 

R 


N 

Negative bit: 

set 

if 

Z 

^ro bit: 

set 

if 

V 

overflow bit: 

set 

if 

c 

Carry bit: 

set 

if 


the result is negative 

the result is zero 

the operation caused an overflow 

the operation caused a carry 


In the representation of the instruction's effect on the condition 
codes, the following symbols are used: 


* Conditionally set 

Not affected 

0 Cleared 

1 Set 
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To set conditionally means to use the instructiort* s result to deter- 
mine the state of the code (see the PDP-11 Handbook) . 


Logical operations are represented by the following symbols: 


! 



& 


Inclusive OR 
Exclusive OR 
AND 

(used over a symbol) NOT (i.e., I's complement) 


B. 3. 1 

Double-Operand Instructions 

Op A, A 









Status 

Word 





Condition Codes 

Op-Code 

Mnemonic 

Stands for 

Operation 

N 

z 

V 

C 

OISSDD 

MOV 

MOVe 

(SE)^(DE) 

* 

* 

0 

- 

IISSDD 

MOVB 

MOVe Byte 






02SSDD 

CMP 

CoMPare 

(SE)- (DE) 

* 

* 

* 

* 

12SSDD 

CMPB 

CoMPare Byte 






03SSDD 

BIT 

Bit Test 

(SE) & (DE) 

* 

* 

0 

_ 

13SSDD 

BITB 

Bit Test Byte 






04SSDD 

BIC 

Bit Clear 

(SE) & (DE)^(DE) 

* 

* 

0 

- 

14SSDD 

BICB 

Bit Clear Byte 






05SSDD 

BIS 

Bit Set 

(SE) ! (DE) -> (DE) 

* 

* 

0 

- 

15SSDD 

BISB 

Bit Set Byte 






06SSDD 

ADD 

ADD 

(SE) + (DE)->-(DE) 

* 

* 

* 

* 

16SSDD 

SUB 

SUBtract 

(DE)- (SE)-»-(DE) 

* 

* 

* 

* 

B. 3. 2 

Single-Operand Instructions 

Op A 









Status 

Word 





Condition Codes 

Op-Code 

Mnemonic 

Stands for 

Operation 

N 

z 

V 

c 

0050DD 

CLR 

CLeaR 

j2r-»'(DE) 

0 

1 

0 

0 

1050DD 

CLRB 

CLeaR Byte 






0051DD 

COM 

COMplement 

(DE)->(DE) 

* 

* 

0 

1 

1051DD 

COMB 

COMplement Byte 






0052DD 

INC 

INCrement 

(DE) +1->(DE) 

* 

* 

* 

- 

1052DD 

INCB 

INCrement Byte 






0053DD 

DEC 

DECrement 

(DE)-l->-(DE) 

* 

* 

* 

- 

1053DD 

DECB 

DECrement Byte 






0054DD 

NEC 

NEGate 

(DE)+1^(DE) 

* 

* 

* 

* 

1054DD 

NEGB 

NEGate Byte 
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Op-Code 

0055DD 

1055DD 

0056DD 

1056DD 

0057DD 

1057DD 

B.3.3 

Op-Code 

0060DD 

1060DD 

0061DD 

1061DD 

0062DD 

1062DD 

0063DD 

1063DD 

OOOIDD 

0003DD 


Status Word 
Condition Codes 


Mhemonic 

Stands for 

Operation 

N 

Z 

V 

c 

ADC 

ADCB 

ADd Carry 

ADd Carry Byte 

(DE) + (C)-^ (DE) 

* 

* 

* 

* 

SBC 

SBCB 

SuBtract Carry 
SuBtract Carry 

(DE)- (C)-> (DE) 

Byte 

* 

* 

■k 

* 

TST 

TSTB 

TeST 

TeST Byte 

(DE) -0->- (DE) 

* 

* 

0 

0 


otate/Shift Instructions 


lemonic 

Stands for 

ROR 

Rotate Right 

RORB 

Rotate Right 
Byte 

ROL 

Rotate Left 

ROLB 

Rotate Left 
Byte 

ASR 

Arithmetic 
Shift Right 

ASRB 

Arithmetic 
Shift Right 
Byte 

ASL 

Arithmetic 
Shift Left 

AS LB 

Arithmetic 
Shift Left 
Byte 

JMP 

Jump 

SWAB 

SWAp Bytes 


Op A 

Operation 


C 16 0 

rCh I 

even or odd byte 
pdK L — . . — - — ]~) 


[~~D *~L _ !H~] 

even or odd byte 

rP HZZ... >1 


c 

□ 


even or odd byte 



even or odd byte 

DE->(PC) 


t T 



Status Word 
Condition Codes 
N Z V C 


* * * * 


* * * * 


* * * * 


* * * 


* 


* * * * 


* * * * 


* * * * 


* * * * 


0 0 
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B.3.4 Operate Instructions 


Op-Code Mnemonic Stands for 


Operation 


Status Word 
Condition Codes 
N Z V C 


000000 


The computer stops all 
functions . 


000001 


000002 


ReTurn 

from 

Inter- 

rupt 


The computer stops and 
and waits for an inter- 
rupt. 

The PC and PS are popped 
off the SP stack; 

( (SP) )-»-(PC) 

(SP)+2-»“(SP) 

{ (SP) )-»'(PS) 

(SP)+2->(SP) 


000005 


RESET 


RESET 


RTI is also used to re- 
turn from a trap. 

Returns all I/O devices 
to power-on state. 


Condition Code Operates 
Op-Code Mnemonic Stands for 


000241 


000261 


CLear Carry bit in PS. 
SEt Carry bit. 


000242 


CLear overflow bit. 


000262 


SEt overflow bit. 


000244 


CLear Zero bit. 


000264 


SEt Zero bit. 


000250 


000270 


000254 


CLear Negative bit. 

SEt Negative bit. 

CLear Negative and Zero bits. 


000257 


Clear all Condition Codes 


000277 


Set all Condition Codes. 


000240 


No operation. 
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B.3.5 Trap Instructions 


Op or Op E 
*0P (only) 


where 0£E£377g 


Status Word 
Condition Codes 


Op-Code 

Mnemonic 

Stands for 

Operation 


N 

Z 

V 

c 

*000003 

(none) 

(breakpoint 

trap) 

Trap to 
is used 

location 14, 
to call ODT, 

This 

* 

* 

* 

* 

*000004 

lOT 

Input/Out- 
put Trap 

Trap to 
is used 

location 20. 
to call lOX. 

This 

* 

* 

* 

* 

104000- 

104377 

EMT 

EMulator 

Trap 

Trap to 
is used 
grams . 

location 30. This 
to call system pro- 

* 

* 

* 

* 

104400 

104777 

TRAP 

TRAP 

Trap to 
is used 
desired 

location 34. This 
to call any routine 
by the programmer. 

* 

* 

* 

* 


B.3.6 Branch Instructions Op E where-128j^Q<_(E- •-2) /2j<127^g 

Condition to be met if 


Op-Code 

Mnemonic 

Stands for 

branch is to occur 

0004XX 

BR 

BRanch always 


OOlOXX 

BNE 

Branch if 
(to zero) 

Not Equal 

Z=0 

0014XX 

BEQ 

Branch if 
zero) 

EQual (to 

Z=1 

0020XX 

BGE 

Branch if 
or Equal 

Greater than 
(to zero) 

n(T)v=o 

0024XX 

BLT 

Branch if 
( zero) 

Less Than 

N Q V=1 

0030XX 

BGT 

Branch if 
( zero) 

Greater Than 

Z! (N(2)V)=0 

0034XX 

BLE 

Branch if 
Equal (to 

Less than or 
zero) 

Z! (n(T)v)=1 

lOOOXX 

BPL 

Branch if 

PLUS 

N=0 

1004XX 

BMI 

Branch if 

Minus 

N=1 

lOlOXX 

BHI 

Branch if 

Higher 

C ! Z = 0 

1014XX 

BLOS 

Branch if 

Lower or Same 

C ! Z = 1 

1020XX 

BVC 

Branch if 

overflow Clear 

V=0 

1024XX 

BVS 

Branch if 

overflow Set 

V=1 

1030XX 

BCC (or 
BHIS) 

Branch if Carry Clear 
(or Branch if Higher or 
Same) 

C=0 

1034XX 

BCS (or 
BLO) 

Branch if 
Branch if 

Carry Set (or 
Lower) 

C=1 
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B.3.7 Subroutine Call 


Op ER, A 


Op-Code Mnemonic 


Stands for 


004RDD JSR 


Jump to SubRoutine 


B.3.8 Subroutine Return Op ER 


Operation 

Push register on the SP stack, 
put the PC in the register; 

DE^{TEMP) - a temporary storage 
register internal 
to processor. 

(SP)-2^(SP) 

(REG)^( (SP) ) 

(PC)-»-(REG) 

(TEMP) -V (PC) 


00020R RTS 


ReTurn from put register in PC and pop old 
Subroutine contents from SP stack into 
register. 


B. 4 

ASSEMBLER DIRECTIVES 


Mnemonic 

Operand 

Stands for 

Operation 

.EOT 

none 

End Of Tape 

Indicates the physical end of 
the source input medium 

.EVEN 

none 

EVEN 

Insures that the assembly loca- 
tion counter is even by adding 

1 if it is odd. 

.END 

E 

END 

Indicates the physical end of 
the program and optionally speci- 
fies the transfer address (E) . 

.WORD 

E, E,... 

E, E, . . . 

WORD 

(the void 
operator) 

Generates words of data 

Generates words of data 

.BYTE 

E,E, . . . 

BYTE 

Generates bytes of data 

.ASCII 

/xxx. . . x/ 

ASCII 

Generates 7-bit ASCII characters 
for text enclosed by delimiters. 

.TITLE 

name 

TITLE 

Generates a name for the object 
module . 

.ASECT 

none 

Absolute 

SECTion 

Initiates the Absolute section. 

. CSECT 

name 

Control 

SECTion 

Initiates and identifies Relocat- 
able Program section (section is 
unnamed if no operand) . 

.LIMIT 

none 

LIMIT 

Generates two words containing 
the low and high limits of the 
relocatable section. 

. GLOBL 

name ,name, 

GLOBaL 

Specifies each name to be a 
global symbol. 

.RAD50 

/XXX/ 

RADix 50 

Generates the RADIX 50 representa- 
tion of the ASCII characters in 


delimiters . 
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Mnemonic 

.IFZ 

Operand 

E 

Stands For 

IF E=0 

.IFNZ 

E 

IF E?^0 

.IFL 

E 

IF E<0 

. IFLE 

E 

IF E<0 

.IFG 

E 

IF E>0 

.IFGE 

E 

IF E>0 

.IFDF 

name 

IF name 
DeFined 

. IFNDF 

name 

IF name 
uNDeFined 

.ENDC 

none 

END of 
Conditional 


Operation 

Assemble what follows up to 
the terminating .ENDC if the 
expression E is 0. 

Assemble what follows up to 
the terminating .ENDC, if the 
expression E is not 0. 

Assemble what follows up to 
the terminating .ENDC, if the 
expression E is less than 0. 

Assemble what follows up to 
the terminating .ENDC, if the 
expression E is less than or 
equal to 0 . 

Assemble what follows up to 
the terminating .ENDC, if the 
expression E is greater than 0 

Assemble what follows up to 
the terminating .ENDC, if the 
expression E is greater than 
or equal to 0 . 

Assemble what follows up to 
the terminating .ENDC if the 
symbol name is defined. 


Assemble what follows up to 
the terminating .ENDC if the 
symbol name is undefined. 

Terminates the range of a con- 
ditional directive. 


B. 5 ERROR CODES 

Error Code Meaning 

A Addressing error. An address within the in- 

struction is incorrect. Also includes relo- 
cation errors . 


B Bounding error. Instructions or word data art 

being assembled at an odd address in memory. 

D Doubly-defined symbol referenced. Reference 

was made to a symbol which is defined more 
than once. 

I illegal character detected. Illegal charac- 

ters which are also non-printing are re- 
placed by a ? on the listing. 
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Error Code 
L 

M 


N 

P 

Q 


R 

T 


U 


Meaning 

Line buffer overflow. All extra characters 
beyond 72 are ignored. 

Multiple definition of a label. A label was 
encountered which was equivalent (in the 
first six characters) to a previously en- 
countered label. 

Number containing an 8 or 9 was not termina- 
ted by a decimal point. 

Phase error. A label's definition or value 
varies from one pass to another. 

Q^uestionable syntax. There are missing argu- 
ments or the instruction scan was not complet 
ed, or a carriage return was not followed by 
a linefeed or form feed. 

Register-type error. An invalid use of or 
reference to a register has been made. 

Truncation error. More than the allotted 
number of bits were input so the leftmost 
bits were truncated. T error does not occur 
for the result of an expression. 

U^ndefined symbol. An undefined symbol was en- 
countered during the evaluation of an ex- 
pression. Relative to the expression, the 
undefined symbol is assigned a value of zero. 
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APPENDIX C 


LINKING PAL-llR AND ITS OVERLAY BUILDER 
AND CONSTRUCTING THE RUN TIME SYSTEM 

At assembly time, the Assembler exists as: 

1. a load module of its core resident portion, and 

2. N non-resident overlays in a contiguous file. 

The Assembler package is delivered to the customer as three (3) 
object modules: 

1. the Assembler (PALllR) 

2. the Permanent Symbol Table (PALSYM) 

3. the Overlay Builder (OVRBLD) 

Two links must be built from these object modules: 

1, the Assembler and the Permanent Symbol Table 

2. the Overlay Builder 

It is imperative that both links have exactly the same TOP 
specified at link time. 

The load module of the Overlay Builder must now be executed via 
the Monitor command RUN. It will produce a contiguous file, 
PALLllR.OVR, on DF0^ with User Identification Code [1,1]. Monitor 
commands CTRL/C BEGIN or CTRL/C RESTART will abort the build process 
and automatically begin it again. When the building is done, control 
will return to the monitor. 

The load module of the Assembler/Permanent Symbol Table may now 
be executed via the monitor command RUN. This run requires the 
presence of the overlay file, PALllR. OVR, on the overlay device DP)?^‘ 
with User Identification Code [1,1]. 

Overlay Size and Makeup 

The size of each overlay on the overlay device and the size of the 


^The file specifier and device may be changed with the Monitor command 
ASSIGN on logical dataset OVR prior to issuing the RUN command. 
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overlay area in core is currently 512 decimal words. This size was 
chosen after examination of the segmentable sections of ttie Assembler 
and their relationships to each other. 


There are currently five overlays: 


OVERLAY #1 

Assembler Initialization 
CSI Interface 
CTRL/C RESTART handler 
OVERLAY #2 

.CSECT assembler directive 
.ASECT " " 

. GLOBL 

.TITLE " 

.LIMIT " " 

GSD (Global Symbol Directory) Output 
Linear Search Routine (used by .CSECT and 
GSD Output routine) 

OVERLAY #3 

•END assembler directive 
Conditional assembler directives 
Symbol Table Lister 
OVERLAY #4 

.ASCII assembler directive 
. BYTE " " 

.RAD5j2f 
. WORD 

Direct Assignment processor 
PASS Initialization 
OVERLAY #5 

GET INPUT LINE ROUTINE 
STATEMENT EVALUATOR 
LABEL FIELD PROCESSOR 
INSTRUCTION PROCESSORS 

PHYSICAL END OF INPUT (EOD) PROCESSOR 


Programming Hints for the User 

The user can organize his source code to cut down on the number of 
overlay transfers needed to accomplish his assembly. 

He should gather all his executable code into one area because 
once OVERLAY #5 is loaded into core to process source lines restricted 
to labels and instructions it will remain in core until one of the 
following occurs: 

1. an assembly directive is encountered 

e . g . , .WORD 

.CSECT 

2. a non-instruction line defaults to .WORD 

e . g . , ADDR 
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3 . 


a direct assignment statement is encountered 

e .g. , A=ipfj2f 

.=.+60 

4. the end of a pass of the assembly process 
Linking the Assembler and the Permanent Symbol Table 

The load module of the Assembler and the Permanent Symbol Table should 
be given the file name; 

PALllR 

PALSYM must be the first object module input to the Linker and PALllR 
the second. This order allows for assembly time core utilization as 
illustrated by the memory map on the following page. 
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|AAAAA/V^^A^/vyy^ 

ASSEMBLER 
(Object Module 2) 
PAL HR 


Ordered to permit 
binary searching. <J 
(4 words/entry) 


Not ordered (4 
words/entry) 


r 


Ordered to permit 
binary searching.^ 
(4 words/entry) 


DOS checks 
for STACK 
Overflow 


Permanent 

Symbols 

(Object Module 1) 

PALSYM 

Unnamed 

Control Section 


Control 

Sections 


User 

Symbols 


STACK 


DOS non- 
resident area 


— The bottom of the stack is 
set-up after initialization 
of all 1st pass I/O devices 
and opening of all 1st pass 
files so that the non-resi- 
dent requirements are known • 
At the end of pass 1 , the 
bottom of the stack is set 
to just below the fixed sjrm- 
bol table. This is done 
prior to initializing and 
opening 2nd pass datasets. 
If the user symbol table 
were to collide with the 

bottom of the stack, the stack is moved down in core in an attempt 
to continue the assembly. This may result in a STACK overflow 
condition. 


Disk 

Operating 

System 


PERBOT 

increasing 
order 


PERTOP 


CONTOP 


i increasing 
order 

j 

USRTOP 


When a Control Sec- 
tion or a user symbol 
gentry is made, the 
User Symbols are ad- 
justed downwards. 


0 


The format of the Permanent Symbol Table (PST) is described 
below to assist users who wish to add and/or delete symbols. 

The PST is a separate object module which is loaded to reside 
immediately below the assembler in core memory. Once assembled, 
it is fixed in size; however, it may be edited, assembled, and 
linked to suit the specific needs of customers. 

The PST is bounded by the internal global symbols SYMTBB and 
SYMTBT, where the former is the highest address of the PST 
and the latter is the address of the 1st word below the PST. 

The PST is ordered (to permit binary searching) with the small- 
est symbol (in RadixSO packed notation) high in core and the 
largest symbol (in RadixSO packed notation) low in core. 

RadixSO character representation: 
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< A thru Z : 1 thru 32 respectively 

$ : 33 

. : 34 

0 thru 9 : 36 thru 47 respectively 

RadixSO packed notation: 

1st packed triad = CHARl*50*50+CHAR2*50+CHAR3 
2nd packed triad = CHAR4*50*50 h-CHAR5*50+CHAR6 

Each entry is 4 words with the lowest word containing the 
1st packed triad. The next lowest containing the 2nd packed 
triad. The next lowest containing the value (which for 
assembler directives is an external global to be linked to 
the appropriate processor in PAL-llR) and the highest word 
containing the flags in the low byte and the control section 
ID (which is always 0 for PST entries) in the high byte. 

Internal global symbols; 

.GLOBL SYMTBB, SYMTBT 

External global symbols: 

.GLOBL ASCII, ASECT, BYTE, CSECT, END 
.GLOBT ENDC, EOT, EVEN, GLOBL, IFDF 
.GLOBL IFG, IFGE, IFL, IFLE, IFNDF 
.GLOBL IFNZ, IFZ , LIMIT, RAD50 
.GLOBL TITLE, WORD 


Flags : 
ASMDIR=10 

BYTFLG=1 


Bit 3 being on in the flag 
Byte indicates that this PST 
entry is an assembler directive. 
Bit 0 being on in the flag 
Byte indicates that this PST 
entry is byte enabled. This 
allows one entry to satisfy 
searches for word and byte 
instructions. E.G. the entry 
'MOV , because bit 0 is on, 
will satisfy searches for 
'MOV or 'MOVB' 


Instruction Class: 

Bits 4-7 of the flag byte designate the 
type of instruction to provide dispatch 
information to PAL-llR. 


SCLAS0=0 

SCLAS1=20 

SCLAS2=40 

SCLAS3=60 

SCLAS4=100 

SCLAS5=120 

SCLAS 6=140 


Operate group 
Unary group 
Binary group 
RTS 

Branch group 
JSR 

TRAP group 
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A listing of the Permanent Symbol Table follows i 


I 


SYMTbT; 

J 

.EVEN 

.WORD 

0 

.WORD 

131247 


.WORD 

070440 


.WORD 

WORD 

I 

. WORD 

ashdir 

1 

.WORD 

131051 


.WORD 

077345 


.WORD 

title 

1 

.WORD 

aSmdir 

.WORD 

130721 


.WORD 

017226 


.WORD 

RAD50 


.WORD 

ASMDIR 

j 

.WORD 

130351 


.WORD 

051274 


.WORD 

LIMIT 

; 

.WORD 

ASMDIR 

.WORD 

130156 


.WORD 

1H1200 


.WORD 

IF?, 


.WORD 

ASMDIR 

; 

. WORD 

130156 


.WORD 

055620 


. WORD 

ifnz 

1 

. WORD 

ASMDIR 

. WORD 

130156 


. WORD 

054046 


.WORD 

IFNDF 

1 

.WORD 

ASMDIR 

} 

.WORD 

130156 


, WORD 

045710 


.WORD 

ifle 

1 

.WORD 

aSMOIR 

.WORD 

130156 


.WORD 

045400 


.WORD 

ifl 

f 

.WORD 

aSmdir 

1 

. WORD 

130156 


.WORD 

026210 


. WORD 

ifge 


.WORD 

ASMDIR 

! 

. WORD 

130156 


.WORD 

025700 


. W 0 R D 

ifg 


.WORD 

ASMDIR 


JlST register below PST 
I .WORD 

J .TITLE 

J ,RAD50 

J .LIMIT 

I .IFZ 

J .IFN2 

I .IFNDF 

J .ifle 

I . IFL 

J .IFGE 

J .IFG 
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.WORD 

130156 

{ 

, IFOF 

• WORD 

014760 



.WORD 

IFDF, 



.WORD 

ASMQIR 



.WORD 

130044 

1 

, GLOBL 

.WORD 

057034 



.WORD 

GLOBL 



.WORD 

aSmoir 



.WORD 

127736 

i 

• EVEN 

.WORD 

020560 



.WORD 

FVEN 



.WORD 

aSmdIR 



. WORD 

127727 

f 

• EOT 

.WORD 

076400 



.WORD 

EOT 



.WORD 

aSmqir 



. WORD 

127726 

f 

• ENDC 

.WORD 

014570 



, WORD 

EMOC 



.WORD 

ASMOIR 



. WORD 

127726 

j 

• END 

.WORD 

014400 



.WORD 

end 



.WORD 

aSmdir 



. WORD 

127613 


•GSECT 

.WORD 

017714 



. WORD 

CSECT 



. WORD 

ASMDIR 



.WORD 

127551 

• 

» 

• BYTE 

.WORD 

076710 



, WORD 

byte 



.WORD 

ASMDIR 



.WORD 

127473 


, ASECT 

. WORD 

017714 



. W 0 R D 

A S E C T 



, WORD 

ashdir 



. WORD 

127473 

t 

•ASCII 

. WORD 

012061 



, W 0 R 1) 

ASCI I 



.WORD 

aSmdir 




} 

} 

J 


. WORD 

107761 

J W A I T 

, WORD 

076400 


. W G R D 

000001 


, W 0 R D 

S C L A S It/ 


.WORD 

100014 

JTST 

. WORD 

0 


.WORD 

005700 


.WORD 

SCLASI+BYTFUC 
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, WORD 

077721 

jTRAP 

.WORD 

062000 


.WORD 

104400 


. WORD 

SCLAS6 


.WORD 

075131 

;Swab 

.WORD 

006200 


.WORD 

000300 


.WORD 

SCLASl 


.WORD 

075012 

jsub 

. WORD 

0 


.WORD 

160000 


.WORD 

SCLAS2 


. WORD 

073642 

jsfz 

.WORD 

0 


.WORD 

000264 


.WORD 

SCLAS0 


.WORD 

073636 

JSFV 

.WORD 

0 


.WORD 

000262 


.WORD 

SCLAS0 


.WORD 

073626 

J SEN 

.WORD 

0 


. WORD 

000270 


.WORD 

SCLAS0 


.WORD 

073613 

} SEC 

.WORD 

0 


.WORD 

000261 


.WORD 

SCLAS0 


.WORD 

073473 

jscc 

.WORD 

0 


.WORD 

000277 


.WORD 

SCUAS0 


.WORD 

073423 

ISDC 

.WORD 

0 


.WORD 

005600 


.WORD 

SCLAS1*8YTFLG 


.WORD 

071663 

>RTS 

.WORD 

0 


.WORD 

000200 


.WORD 

SCLAS3 


.WORD 

071651 

IRTI 

.WORD 

0 


.WORD 

000002 


.WORD 

SCLAS0 


.WORD 

071352 

;ROR 

.WORD 

0 


.WORD 

006000 


.WORD 

SCLASI+BYTFLG 
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.WORD 

071344 

JROl 

, WORD 

0 


.WORD 

006100 


.WORD 

SCLAS1+8YTFLG 


.WORD 

070533 

IRFSET 

.WORD 

021140 


.WORD 

000005 


.WORD 

SCLAS0 


-.WORD 

054750 

JNOP 

.WORD 

0 


.WORD 

000240 


.WORD 

SCLAS0 


.WORD 

054117 

>NEG 

.WORD 

0 


.WORD 

005400 


.WORD 

SCLASl+BYTFLG 


.WORD 

051656 

JHOV 

.WORD 

0 


.WORD 

010000 


.WORD 

SCLAS2+8YTFLG 


.WORD 

040612 

I>JSR 

.WORD 

0 


.WORD 

004000 


. WORD 

SCLAS5 


.WORD 

040230 

1 JHP 

.WORD 

0 


.WORD 

000100 


.WORD 

SCLASl 


.WORD 

035254 

HOT 

.WORD 

0 


.WORD 

000004 


.WORD 

SCL.AS0 


.WORD 

035163 

IIWC 

.WORD 

0 


.WORD 

005200 


.WORD 

sclasi+bytflg 


. W 0 R [3 

031064 

jhalt 

. W 0 R 1 .) 

076400 


.WORD 

0 


.WORD 

SCI.AS0 


.WORD 

020534 

jEMT 

.WORD 

0 


.WORD 

104000 


.WORD 

SCLAS6 


.WORD 

014713 

;DEC 

. WORD 

0 


.WORD 

005300 


.WORD 

SCLAS1+8YTFLG 
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w 0 R n 

012445 

J COM 

W 0 R D 

0 


w n R D 

005100 


WORD 

SCLASI+BYTFLG 


WORD 

012412 


WORD 

0 


WORD 

000254 


WORD 

SCLAS0 


WORD 

012330 

>CMP 

WORD 

0 


WORD 

020000 


WORD 

SCLAS2+BYTFLG 


WORD 

012272 

iClI 

WORD 

0 


WORD 

000244 


WORD 

SCLAS0 


WORD 

012266 

5CLV 

WORD 

0 


WORD 

000242 


WORD 

SCLAS0 


WORD 

012262 

JCLR 

WORD 

0 


WORD 

005000 


WORD 

SCLASI+BYTFLG 


WORD 

012256 

iCLNi 

WORD 

0 


WORD 

000250 


WORD 

SCLAS0 


WORD 

012243 

JCLC 

WORD 

0 


WORD 

000241 


WORD 

SCLAS0 


WORD 

011473 

JCCC 

WORD 

0 


WORD 

000257 


WORD 

SCLAS0 


WORD 

010003 

IBVS 

WORD 

0 


WORD 

102400 


WORD 

SCLAS4 


WORD 

007763 

IBVC 

WORD 

0 


WORD 

102000 


WORD 

SCLAS4 


WORD 

007520 

IBR 

WORD 

0 


WORD 

000400 


WORD 

SCLAS4 



C-10 



.WORD 

007414 

IBPL 

.WORD 

0 


.WORD 

100000 


.WORD 

SCIAS4 


.WORD 

007265 

»BNE 

.WORD 

0 


.WORD 

001000 


, WORD 

SCLAS4 


.WORD 

007221 

JBMI 

.WORD 

0 


.WORD 

100400 


.WORD 

SCLAS4 


.WORD 

007164 

J8LT 

, WORD 

0 


.WORD 

002400 


.WORD 

SCLAS4 


.WORD 

007157 

JBLOS 

. WORD 

073300 


. WORD 

101400 


. WORD 

SCUAS4 


.WORD 

007157 

;8L0 

.WORD 

d 


, WORD 

103400 


. WORD 

SCLAS4 


. W 0 R'D 

007145 

JBIE 

. WORD 

0 


.WORD 

003400 


. WORD 

SCLAS4 


.WORD 

006774 

)BIT 

.WORD 

0 


, WORD 

030000 


.WORD 

SCLAS2+BVTFLG 


. WORD 

006773 

IBIS 

. WORD 

0 


, WORD 

050000 


.WORD 

SCLAS2+BYTFLG 


. WORD 

006753 

IBIC 

. WORD 

0 


, W 0 R D 

040000 


.WORD 

SCLAS2+BYTrLG 


, WORD 

006711 

IBHIS 

. WORD 

073300 


, WORD 

103000 


, WORD 

SCLAS4 


, WORD 

006711 

IBM I 

, WORD 

0 


, W 0 R D 

101000 


, W 0 R !.l 

SCLAS4 
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; 


} 


i 


I 


j 


i 


} 

I 

i 

symtrq= 


. 0 R D 

006654 

. w 0 R n 

0 

.WORD 

003000 

. W 0 R D 

SCLAS4 

. W 0 R 1.) 

006635 

, <« 0 R [) 

0 

.WORD 

002000 

. WORD 

SCLAS4 

.WORD 

006531 

.WORD 

0 

.WORD 

001400 

.WORD 

SCLAS4 

, y- 0 R D 

006413 
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INDEX 


Absolute symbol, see Symbols 
Address modes, 7-2 
Addressing, 7-1 
ASCII conversion, 4-2, 8-7 
Assembler directives, 8-1, 9-6 
Assembly location counter, 2-2, 
4-1, 5-1, 7-6, 7-7, 8-2, 8-5 
Assembly passes, 5-1, 9-1, 9-6 
Assignment, direct, 3-2, 9-8 


Boolean operators, 4-2 


Character set, 2-1 
Command string, 9-1 

default condition, 9-2 
errors, 9-2 
format, 9-1 
switches, 9-3 
Comment field, 2-4, 8-1 


Datasets, ,9-4 
Decimal specification, 4-1 
Direct assignment, 3-2, 5-1, 9-8 
Dot, 2-2, 4-1, 5-1, 7-6, 7-7, 
8-2, 8-5 


Entry point symbol, see Symbols 
Errors, 2-1, 2-2, 3-1, 3-4, 4-2, 
8-6, 9-7 

codes for, 10-1 
command string, 9-2 
keyboard, 9-1 
Expressions, 4-1 
External symbol, see Symbols 


Fields, statement, 2-1, 4-1, 5-1 

7-7, 8-1, 8-5 
Formatting, 2-4 


Global symbols, see Symbols 


Instruction formats, 7-7 
Internal symbols, see Symbols 


Labels, 2-2, 8-1, 8-3 
Listing, 9-7 

Load module, 1-1, 6-1, 8-5 
Loading, 9-1 

Location counter, 2-2, 4-1, 5-1, 
7-6, 7-7, 8-2, 8-5 


Logical operators, 4-2 


Modes, address, 7-2 


Numerical representation, 4-1 


Object module, 1-1, 6-1, 8-1, 
9-1, 9-8 
Offsets , 

branch, 7-8 
relative mode, 7-5 
Operand field (also see Address 
modes), 2-3, 4-1, 5-1, 7-7 

8-1, 8-5, 8-10 
Operating procedures, 9-1 
Operator field, 2 t- 3, 4-1, 8-1 
Operators, arithmetic and 
logical, 4-2 


Pages, 2-4 

Paper tape reader, 9-6 
Passes, assembly, 5-1, 9-1, 9-6 
Permanent symbols , see Symbols 
Program Counter (PC), 7-1, 7-4, 

7-8 

Pseudo-ops, see Assembler 
directives 


Register symbols, see Symbols 
Registers, general, 3-3, 7-1 
Relocatable symbol, see Symbols 
Restarting, 9-7 


Starting, 9-1 

Symbol tables, 3-1, 8-10, 9-1, 
9-5 

Symbols, 3-1, 6-1, 8-1 

absolute, 3-2, 4-3, 6-1, 7-8 
direct assignment, 3-2, 5-1, 9-8 
entry point, 3-2, 8-1 
external, 3-2, 4-3, 5-1, 6-1, 
7-8, 8-1 

global, 1-1, 3-2, 4-1, 8-1, 

9-8 

internal, 3-2, 8-4 
labels, 2-2, 8-1, 8-3 
permanent, 3-1, 4-1, 4-3 
register, 3-3 
relocatable, 3-2, 4-1, 4-3, 
6-1, 7-8 

user-defined, 3-1, 9-1 
Terminators, 2-1, 2-3, 8-10 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equifwnent Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Proc?‘'am Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively v/e need user feedback — your critical evaluation of 
this manual. 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department; 


City: 

State; 


Zip or Country 
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